Creates a log filter with the specified name.
name | Specifies the name of the filter to create. |
copy | Specifies that the new filter is to be copied from an existing one. |
filter_name | Specifies the existing filter to copy. |
N/A.
This command creates a filter with the name specified. A filter is a customizable list of events to include or exclude, and optional parameter values. The list of events can be configured by component or subcomponent with optional severity, or individual condition, each with optional parameter values. See the commands configure log filter events and configure log filter events match for details on how to add items to the filter.
The filter can be associated with one or more targets using the configure log target filter command to control the messages sent to those targets. The system has one built-in filter named DefaultFilter, which itself may be customized. Therefore, the create log filter command can be used if a filter other than DefaultFilter is desired. As its name implies, DefaultFilter initially contains the default level of logging in which every ExtremeXOS component and subcomponent has a pre-assigned severity level.
If another filter needs to be created that will be similar to an existing filter, use the copy option to populate the new filter with the configuration of the existing filter. If the copy option is not specified, the new filter will have no events configured and therefore no incidents will pass through it.
The total number of supported filters, including DefaultFilter, is 20.
The following command creates the filter named fdb2, copying its configuration from the filter DefaultFilter:
create log filter fdb2 copy DefaultFilter
This command was first available in ExtremeXOS 10.1.